home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 02 Help & Utilities / ACROSS.TXT < prev    next >
Text File  |  2019-04-13  |  14KB  |  369 lines
  1. ABOUT ACROSS LIBRRARY SEARCHING
  2. October, 1991
  3.  
  4.  
  5. GENERAL DESCRIPTION
  6. ===================
  7.  
  8.   CompuServe has released a new version of the Forum Libraries, which provides
  9. many additional features.  The main enhancement is the ability to find a file
  10. within a forum -- no matter what library you are in. Other features include:
  11.  
  12. * a new directory display, providing more information in an
  13. easier-to-understand format
  14. * the ability to move backwards as well as forwards through a BROWSE
  15. * new valid characters for file names
  16. * easier-to-understand error messages
  17. * the ability to count files in the libraries more easily
  18. * and, improved context sensitive HELP, available with the HELP command.
  19.  
  20. All features are outlined below. They are available in ASCII mode. Changes
  21. will be incorporated into the CompuServe Information Manager at a later date.
  22.  
  23. CHANGES FOR MENU MODE USERS
  24. ===========================
  25.  
  26. A New Prompt
  27.  
  28.   For "Menu Mode" users, almost everything will look and feel the same as
  29. the previous version of the Libraries.  You still enter the libraries by first
  30. selecting "LIBRARIES" from the main Forum Menu, and then by selecting the
  31. library you prefer from the next menu.
  32.  
  33. However, selecting BROWSE from the main Library menu will shed light on the 
  34. first change in the new Libraries -- the addition of one prompt. Here's what
  35. it looks like:
  36.  
  37.        IBM Communications Forum    Library 2
  38.  
  39.        Comm Utilities
  40.  
  41.         1 BROWSE Files
  42.         2 DIRECTORY of Files
  43.  
  44.         3 UPLOAD a File (FREE)
  45.         4 DOWNLOAD a file to your Computer
  46.  
  47.         5 LIBRARIES
  48.  
  49.        Enter choice ! 1                          <==== Choose BROWSE
  50.  
  51.        Enter libraries (e.g. 1,2,4 or ALL)              <==== * New Prompt *
  52.        or <CR> for current library: 
  53.  
  54.        Enter keywords (e.g. modem)               <==== Same as previous
  55.        or <CR> for all:                                      version
  56.  
  57.        Oldest files in days                      <==== Same as previous
  58.        or <CR> for all:                                      version
  59.  
  60.   Note the new "Libraries" prompt. You have two options here. You can simply
  61.   press a carriage return (<CR>) to select from files in the current library.
  62.   This works the same way as the BROWSE selection worked in the previous 
  63.   Library version.  Or, at this prompt, you may type in numbers corresponding
  64.   to the specific libraries that you wish to browse.
  65.  
  66.   Each library number should be separated by a comma or a space, as in "1,3,5,"
  67.   to browse files in libraries 1, 3, and 5.  Only files in the libraries you
  68.   enter will be browsed.  For example, if you are in Library 2, and enter a "4"
  69.   at the new prompt, only files in library 4 will be displayed. 
  70.  
  71.   At the prompt, you may also use the hyphen ("-") to specify ranges of
  72.   libraries, as in "1-6," to indicate that you want to browse files in
  73.   libraries 1 through 6. 
  74.  
  75.   You can mix and match the approaches, as in "1,3,7-11," to browse libraries
  76.   1, 3, and 7 through 11. If you want to examine the files in all libraries 
  77.   at once, you can type the word "ALL."
  78.  
  79. A New Format for File Displays
  80.  
  81.   The second thing a Menu Mode user will notice is the new format for the
  82.   File displays. The displays have been re-arranged, and are easier to read 
  83.   and to understand.  In addition, the Library number is included in the 
  84.   display when you're searching for files in libraries other than your
  85.   "current" library.  See the examples at the end of this document for more
  86.   details about these changes.
  87.  
  88.   "P" Means "Previous;" "B" Means "Back"
  89.  
  90.   While BROWSING, a "Disposition" prompt displays after each file. Pressing 
  91.   <CR> at this prompt takes you to the next file. If you press <CR> too many
  92.   times, or want to move back to a previous file, you can now do so.
  93.  
  94.   Enter a "P" and press <CR> to back up one file. You may also use "B" for
  95.   "Back," if you wish.  It works exactly the same as "P."
  96.  
  97. CHANGES FOR COMMAND MODE USERS
  98. ==============================
  99.  
  100. The "LIB:" Command
  101.  
  102. For "Command Mode" users, several new commands and options have been added.
  103. All commands in the previous version continue to work, and you still enter the
  104. libraries in the same way.
  105.  
  106. The most important addition is the "LIB:" option.  This command can be used in
  107. conjunction with almost every existing command (DIR, BROWSE, DOWNLOAD, etc.)
  108. to designate a library or libraries.
  109.  
  110. For example:
  111.  
  112.        DIR LIB:4
  113.  
  114. will display a directory of all files in library 4, newest first. You can be
  115. as specific as you want. More examples:
  116.  
  117.      COMMANDS                      RESULT
  118.  
  119.  DIR A*.* LIB:1-5       - Directory of all files starting with the letter "A"
  120.                         in libraries 1 through 5, in alphabetical order.
  121.  
  122.  DIR KEY:GAME LIB:ALL   - Directory of all files with a keyword of "GAME" in
  123.                         all libraries the user has access to, newest first.
  124.  
  125.  DIR *.TXT LIB:1,5,7-9  - Directory of all files with the "TXT" extension 
  126.                         in Libraries 1, 5, and 7 through 9, in alphabetical
  127.                         order.
  128.  
  129.  DIR AGE:30 LIB:ALL      - Directory of all files uploaded in the last 30 days
  130.                          in all libraries, newest first.
  131.  
  132. Two New Commands: LIST and COUNT
  133.  
  134.  Two new commands, LIST and COUNT, have been added as well. Here are 
  135.  specifics:
  136.  
  137.  
  138.   LIST        - This command is simply a short cut for a "DIR SHORT".  It
  139.                 will always give the one-line-per-file "short" listing,
  140.                 regardless of your "Library Options" setting.  It has the
  141.                 same syntax and options as the DIR command.
  142.  
  143.   COUNT       - This command allows you to count the number of files in a
  144.                 Library or Libraries.  It has the same syntax and options
  145.                 as the DIR command.  However, this command does not display
  146.                 the files, but only a summary count of files.  In this way,
  147.                 you can count the number of files that will be listed by 
  148.                 an equivalent DIR command (so you can "preview" a potentially
  149.                 long listing).
  150.  
  151.         Examples:
  152.  
  153.         COUNT                    - Count of all files in the current Library.
  154.  
  155.         COUNT LIB:ALL            - Count of all files in all Libraries.
  156.  
  157.         COUNT KEY:GAME LIB:ALL   - Count of all files with the keyword GAME in
  158.                                    all libraries.
  159.  
  160.  
  161.   To accompany the "COUNT" command, the DIR and LIST commands have a new
  162. option, the "COUNT" option.  When this option is specified, a summary count of
  163. the files displayed is shown at the end of the listing.  Just add COUNT to
  164. the command line (COUNT can be abbreviated to the first three letters "COU",
  165. or to "CNT").
  166.  
  167.   For example:
  168.  
  169.   DIR *.* COUNT       - Lists all files in the current directory in 
  170.                       alphabetical order, and prints the total number listed at
  171.                       the end.
  172.  
  173. Enhanced "AGE:" and "DAY:" Options
  174.  
  175.   The "AGE:" and "DAY:" options have been enhanced to accept ranges of days.
  176. You can now specify that only files OLDER than a given number of days be
  177. listed, or that only files with ages that fall in a given range of days
  178. be listed.  The "AGE:" and "DAY:" options work identically.
  179.  
  180.   Examples:
  181.  
  182.   DIR AGE:30    - This command produces a directory of files uploaded between
  183.                   today, and 30 days ago.
  184.  
  185.   DIR AGE:30-   - This command produces a directory of files uploaded MORE
  186.                   than 30 days ago.
  187.  
  188.   LIST DAY:30-90  - This command produces a listing of files uploaded between
  189.                   30 and 90 days ago.
  190.  
  191. File Name Characters and Keywords
  192.  
  193. For all users, the valid characters that can be used for a File Name in
  194. the Libraries have been extended.  The following characters are now valid
  195. in file names and extensions for files uploaded to the CompuServe Libraries:
  196.  
  197.   A-Z  0-9  @  #  $  %  -  _  &  +
  198.  
  199. File names are still limited to only six characters.  If an invalid character
  200. is found in a file name, or if the name is too long, it will not be accepted.
  201.  
  202. Keywords have changed just a bit too.  The maximum length of a keyword is
  203. now 17 characters, and may consist of _only_ the following characters:
  204.  
  205.   A-Z  0-9  _  -  &  .
  206.  
  207. There are also a maximum of 10 keywords per file, and any duplicate keywords
  208. are automatically removed.  There is a "Stop-List" of keywords that are
  209. removed as well:
  210.  
  211.        A      ALL    AN     AND    ARE    BUT    BY     FOR
  212.        FROM   I      IN     IS     IT     ME     MY     NOT
  213.        OF     ON     SO     THAT   THE    THIS   TO     TOO
  214.        WITH   YOU
  215.  
  216.   None of the keywords that are automatically removed count towards the
  217. 10-keyword maximum per file.
  218.  
  219.   You can search for multiple keywords at once by separating them with
  220. commas, as in:
  221.  
  222.   DIR KEY:GAME,BOARD LIB:ALL
  223.  
  224.   The above command will produce a directory of all files in all libraries
  225. that have the keyword GAME _and_ the keyword BOARD.
  226.  
  227.  
  228. EXAMPLES OF NEW DIRECTORY DISPLAYS
  229. ==================================
  230.  
  231. 1) Example of the new DIRectory format:
  232.  
  233. Lib 4! DIR
  234.  
  235. [70000,1047]
  236. TEST.TXT/Asc    Bytes:   9295, Count:    0, 22-Jul-91
  237.  
  238. [76702,1102]
  239. COMDL4.DES/Asc  Bytes:   1503, Count:   36, 01-Jan-91
  240.  
  241. [72777,1312]
  242. DELFAC.ZIP/Bin  Bytes:  14152, Count:   18, 13-Nov-90
  243.  
  244. [73407,3163]
  245. DVINTS.ZIP/Bin  Bytes:   9806, Count:   33, 21-Oct-90
  246.  
  247. [70130,330]
  248. TTLSLC.ZIP/Bin  Bytes:   3443, Count:   50, 22-Aug-90
  249. TTLCTL.EXE/Bin  Bytes: 107373, Count:  251, 22-Aug-90
  250. TTLCTL.TXT/Asc  Bytes:   1942, Count:  448, 19-Aug-90
  251.  
  252. [73530,2037]
  253. XFAX15.ZIP/Bin  Bytes:  39936, Count:   91, 21-Jun-90
  254.  
  255. [remainder deleted for brevity]
  256.  
  257.  
  258. 2) Example of the new DIRectory format with Library number:
  259.  
  260. Lib 4! DIR LIB:4            <=== Use the LIB: option to "force" the
  261.                                  display of the library number.
  262.  
  263. [70000,1047]    Lib: 4
  264. TEST.TXT/Asc    Bytes:   9295, Count:    0, 22-Jul-91
  265.  
  266. [76702,1102]    Lib: 4
  267. COMDL4.DES/Asc  Bytes:   1503, Count:   36, 01-Jan-91
  268.  
  269. [72777,1312]    Lib: 4
  270. DELFAC.ZIP/Bin  Bytes:  14152, Count:   18, 13-Nov-90
  271.  
  272. [73407,3163]    Lib: 4
  273. DVINTS.ZIP/Bin  Bytes:   9806, Count:   33, 21-Oct-90
  274.  
  275. [70130,330]     Lib: 4
  276. TTLSLC.ZIP/Bin  Bytes:   3443, Count:   50, 22-Aug-90
  277. TTLCTL.EXE/Bin  Bytes: 107373, Count:  251, 22-Aug-90
  278. TTLCTL.TXT/Asc  Bytes:   1942, Count:  448, 19-Aug-90
  279.  
  280. [73530,2037]    Lib: 4
  281. XFAX15.ZIP/Bin  Bytes:  39936, Count:   91, 21-Jun-90
  282.  
  283. [remainder deleted for brevity]
  284.  
  285.  
  286. 3) Example of the new LIST (DIR SHORT) format:
  287.  
  288. Lib 4! LIST                 <=== The library number is *always*
  289.                                  displayed in the LIST or DIR SHORT
  290.                                  displays.  The File Type has been
  291.                                  removed to make room for the Lib number.
  292.  
  293. TEST.TXT    4   10K 07-22-91 test upload
  294. COMDL4.DES  4    2K 01-01-91 One-line descriptions of files in Library 4
  295. DELFAC.ZIP  4   14K 11-13-90 Delete Fax Files
  296. DVINTS.ZIP  4   10K 10-21-90 DESQVIEW PIF AND PROGRAMS FOR BITFAX
  297. TTLSLC.ZIP  4    4K 08-22-90 FHOST.SLC for prev dwnld of TTLCTL.EXE & TELIX us
  298. TTLCTL.EXE  4  105K 08-22-90 TotalCtl, the software phone switch see TTLCTL.TX
  299. TTLCTL.TXT  4    2K 08-19-90 Short text file describing TTLCTL.EXE more fully
  300. XFAX15.ZIP  4   40K 06-21-90 XFAX v1.5: allows one fax to service network
  301.  
  302. [remainder deleted for brevity]
  303.  
  304.  
  305. 4) Example of the new BROWSE format:
  306.  
  307. Lib 4! BROWSE LIB:4
  308.  
  309. [70000,1047]    Lib: 4
  310. TEST.TXT/Asc    Bytes:   9295, Count:    0, 22-Jul-91
  311.  
  312.   Title   : test upload
  313.   Keywords: TEST UPLOAD
  314.  
  315.   This is a test upload.
  316.  
  317. Disposition !
  318.  
  319.  
  320. [76702,1102]    Lib: 4
  321. COMDL4.DES/Asc  Bytes:   1503, Count:   36, 01-Jan-91
  322.  
  323.   Title   : One-line descriptions of files in Library 4
  324.   Keywords: LIBRARY4 DIRECTORY SUMMARY BRIEF DESCRIPTIONS
  325.  
  326.   One-line descriptions of files in Lib 4 as of Jan 1, 1991. 
  327.   Updates (including separate change file) are prepared approximately monthly. 
  328.   The file showing changes since Dec 1 for all Libs is in Lib 0 as 
  329.   COMCHG.DEC. If you want all the summaries for Libs 1-7,9-11, COMSUM.ZIP is 
  330.   available in Lib0.  (This is an ASCII file which can be Read and captured to 
  331.   disk or downloaded with a protocol.)
  332.  
  333. Disposition !
  334.  
  335.  
  336. [72777,1312]    Lib: 4
  337. DELFAC.ZIP/Bin  Bytes:  14152, Count:   18, 13-Nov-90
  338.  
  339.   Title   : Delete Fax Files
  340.   Keywords: FAX COMPLETEFAX SHAREWARE DELETE UTILITY
  341.  
  342.   This is a utility file to delete facsimile files created by the CompleteFax 
  343.   Board or similar boards using file names with numerical extensions.  Files 
  344.   are deleted based on age in the range of 1-30 days. Particularly useful to 
  345.   prevent filling up a hard disk while still preserving files for possible 
  346.   reuse.  Zip file includes executable file  and documentation.  Written in
  347.   Pascal.
  348.  
  349. Disposition !
  350.  
  351.  
  352. [remainder deleted for brevity]
  353.  
  354. 5) Example of LISTING across libraries:
  355.  
  356. Lib 4! LIST LIB:ALL
  357.  
  358. CISEXE.BIN 15    7K 08-02-91 Script for Dialogue 128 use of CIS forums rev. 30
  359. GAMES.ZIP   8  160K 07-31-91 Games file.  DO NOT DISTRIBUTE
  360. CISOP.TXT   1    5K 07-29-91 Information about CISOP (Automate CIS OPerations)
  361. USTBUG.LOG  5    7K 07-27-91 Bug, UST, Capture
  362. TEST.TXT    1    2K 07-27-91 Test
  363. SENDS.TXT   5    7K 07-27-91 CON Demonstrating Problems with the NOSEN Command
  364. RAM2WS.SX  15   18K 07-28-91 Test binary upload
  365. USTBUG.TXT  6    5K 07-22-91 Capture of a session dealing with UST bug.
  366. TEST.TXT    4   10K 07-22-91 test upload
  367. SENBUG.ARC  6    7K 07-22-91 capture of a problem with SENS
  368. NOUSER.BUG  3    9K 07-22-91 Capture of NOUSERS bug.
  369.